Removes every item in a collection.

void EmptyCollection (
    Collection c
);

Parameter descriptions

c

A reference to the collection object you want to empty. The behavior of this function is undefined if you do not provide a reference to a valid collection object.

DISCUSSION

This function removes every item in the collection referenced by the c parameter. This function provides the fastest mechanism for emptying a collection.

To remove all of the items in a collection whose attributes match a specified pattern, use the PurgeCollection function.

To remove all of the items in a collection with a specified collection tag, use the PurgeCollectionTag function.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)